/ Celestin Apprentice 4 / Apprentice-Release4.iso / Source Code / C / Applications / Python 1.3 / source code / Doc / libppath.tex

< prev

next >

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 73 65 63 74 69 6f 6e | 7b 53 74 61 6e 64 61 72 |\section|{Standar|
|00000010| 64 20 4d 6f 64 75 6c 65 | 20 5c 73 65 63 74 63 6f |d Module| \sectco|
|00000020| 64 65 7b 70 6f 73 69 78 | 70 61 74 68 7d 7d 0d 5c |de{posix|path}}.\|
|00000030| 73 74 6d 6f 64 69 6e 64 | 65 78 7b 70 6f 73 69 78 |stmodind|ex{posix|
|00000040| 70 61 74 68 7d 0d 0d 54 | 68 69 73 20 6d 6f 64 75 |path}..T|his modu|
|00000050| 6c 65 20 69 6d 70 6c 65 | 6d 65 6e 74 73 20 73 6f |le imple|ments so|
|00000060| 6d 65 20 75 73 65 66 75 | 6c 20 66 75 6e 63 74 69 |me usefu|l functi|
|00000070| 6f 6e 73 20 6f 6e 20 50 | 4f 53 49 58 20 70 61 74 |ons on P|OSIX pat|
|00000080| 68 6e 61 6d 65 73 2e 0d | 0d 5c 73 74 72 6f 6e 67 |hnames..|.\strong|
|00000090| 7b 44 6f 20 6e 6f 74 20 | 69 6d 70 6f 72 74 20 74 |{Do not |import t|
|000000a0| 68 69 73 20 6d 6f 64 75 | 6c 65 20 64 69 72 65 63 |his modu|le direc|
|000000b0| 74 6c 79 2e 7d 20 20 49 | 6e 73 74 65 61 64 2c 20 |tly.}  I|nstead, |
|000000c0| 69 6d 70 6f 72 74 20 74 | 68 65 0d 6d 6f 64 75 6c |import t|he.modul|
|000000d0| 65 20 5c 63 6f 64 65 7b | 6f 73 7d 20 61 6e 64 20 |e \code{|os} and |
|000000e0| 75 73 65 20 5c 63 6f 64 | 65 7b 6f 73 2e 70 61 74 |use \cod|e{os.pat|
|000000f0| 68 7d 2e 0d 5c 73 74 6d | 6f 64 69 6e 64 65 78 7b |h}..\stm|odindex{|
|00000100| 6f 73 7d 0d 0d 5c 72 65 | 6e 65 77 63 6f 6d 6d 61 |os}..\re|newcomma|
|00000110| 6e 64 7b 5c 69 6e 64 65 | 78 73 75 62 69 74 65 6d |nd{\inde|xsubitem|
|00000120| 7d 7b 28 69 6e 20 6d 6f | 64 75 6c 65 20 70 6f 73 |}{(in mo|dule pos|
|00000130| 69 78 70 61 74 68 29 7d | 0d 0d 5c 62 65 67 69 6e |ixpath)}|..\begin|
|00000140| 7b 66 75 6e 63 64 65 73 | 63 7d 7b 62 61 73 65 6e |{funcdes|c}{basen|
|00000150| 61 6d 65 7d 7b 70 7d 0d | 52 65 74 75 72 6e 20 74 |ame}{p}.|Return t|
|00000160| 68 65 20 62 61 73 65 20 | 6e 61 6d 65 20 6f 66 20 |he base |name of |
|00000170| 70 61 74 68 6e 61 6d 65 | 0d 5c 76 61 72 7b 70 7d |pathname|.\var{p}|
|00000180| 2e 0d 54 68 69 73 20 69 | 73 20 74 68 65 20 73 65 |..This i|s the se|
|00000190| 63 6f 6e 64 20 68 61 6c | 66 20 6f 66 20 74 68 65 |cond hal|f of the|
|000001a0| 20 70 61 69 72 20 72 65 | 74 75 72 6e 65 64 20 62 | pair re|turned b|
|000001b0| 79 0d 5c 63 6f 64 65 7b | 70 6f 73 69 78 70 61 74 |y.\code{|posixpat|
|000001c0| 68 2e 73 70 6c 69 74 28 | 5c 76 61 72 7b 70 7d 29 |h.split(|\var{p})|
|000001d0| 7d 2e 0d 5c 65 6e 64 7b | 66 75 6e 63 64 65 73 63 |}..\end{|funcdesc|
|000001e0| 7d 0d 0d 5c 62 65 67 69 | 6e 7b 66 75 6e 63 64 65 |}..\begi|n{funcde|
|000001f0| 73 63 7d 7b 63 6f 6d 6d | 6f 6e 70 72 65 66 69 78 |sc}{comm|onprefix|
|00000200| 7d 7b 6c 69 73 74 7d 0d | 52 65 74 75 72 6e 20 74 |}{list}.|Return t|
|00000210| 68 65 20 6c 6f 6e 67 65 | 73 74 20 73 74 72 69 6e |he longe|st strin|
|00000220| 67 20 74 68 61 74 20 69 | 73 20 61 20 70 72 65 66 |g that i|s a pref|
|00000230| 69 78 20 6f 66 20 61 6c | 6c 20 73 74 72 69 6e 67 |ix of al|l string|
|00000240| 73 20 69 6e 0d 5c 76 61 | 72 7b 6c 69 73 74 7d 2e |s in.\va|r{list}.|
|00000250| 0d 49 66 0d 5c 76 61 72 | 7b 6c 69 73 74 7d 0d 69 |.If.\var|{list}.i|
|00000260| 73 20 65 6d 70 74 79 2c | 20 72 65 74 75 72 6e 20 |s empty,| return |
|00000270| 74 68 65 20 65 6d 70 74 | 79 20 73 74 72 69 6e 67 |the empt|y string|
|00000280| 20 28 5c 63 6f 64 65 7b | 27 27 7d 29 2e 0d 5c 65 | (\code{|''})..\e|
|00000290| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0d 0d 5c 62 |nd{funcd|esc}..\b|
|000002a0| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 65 |egin{fun|cdesc}{e|
|000002b0| 78 69 73 74 73 7d 7b 70 | 7d 0d 52 65 74 75 72 6e |xists}{p|}.Return|
|000002c0| 20 74 72 75 65 20 69 66 | 0d 5c 76 61 72 7b 70 7d | true if|.\var{p}|
|000002d0| 0d 72 65 66 65 72 73 20 | 74 6f 20 61 6e 20 65 78 |.refers |to an ex|
|000002e0| 69 73 74 69 6e 67 20 70 | 61 74 68 2e 0d 5c 65 6e |isting p|ath..\en|
|000002f0| 64 7b 66 75 6e 63 64 65 | 73 63 7d 0d 0d 5c 62 65 |d{funcde|sc}..\be|
|00000300| 67 69 6e 7b 66 75 6e 63 | 64 65 73 63 7d 7b 65 78 |gin{func|desc}{ex|
|00000310| 70 61 6e 64 75 73 65 72 | 7d 7b 70 7d 0d 52 65 74 |panduser|}{p}.Ret|
|00000320| 75 72 6e 20 74 68 65 20 | 61 72 67 75 6d 65 6e 74 |urn the |argument|
|00000330| 20 77 69 74 68 20 61 6e | 20 69 6e 69 74 69 61 6c | with an| initial|
|00000340| 20 63 6f 6d 70 6f 6e 65 | 6e 74 20 6f 66 20 5c 73 | compone|nt of \s|
|00000350| 61 6d 70 7b 5c 7e 7d 20 | 6f 72 0d 5c 73 61 6d 70 |amp{\~} |or.\samp|
|00000360| 7b 5c 7e 5c 76 61 72 7b | 75 73 65 72 7d 7d 20 72 |{\~\var{|user}} r|
|00000370| 65 70 6c 61 63 65 64 20 | 62 79 20 74 68 61 74 20 |eplaced |by that |
|00000380| 5c 76 61 72 7b 75 73 65 | 72 7d 27 73 20 68 6f 6d |\var{use|r}'s hom|
|00000390| 65 20 64 69 72 65 63 74 | 6f 72 79 2e 20 20 41 6e |e direct|ory.  An|
|000003a0| 0d 69 6e 69 74 69 61 6c | 20 5c 73 61 6d 70 7b 5c |.initial| \samp{\|
|000003b0| 7e 7b 7d 7d 20 69 73 20 | 72 65 70 6c 61 63 65 64 |~{}} is |replaced|
|000003c0| 20 62 79 20 74 68 65 20 | 65 6e 76 69 72 6f 6e 6d | by the |environm|
|000003d0| 65 6e 74 20 76 61 72 69 | 61 62 6c 65 20 5c 63 6f |ent vari|able \co|
|000003e0| 64 65 7b 5c 24 7b 7d 48 | 4f 4d 45 7d 3b 0d 61 6e |de{\${}H|OME};.an|
|000003f0| 20 69 6e 69 74 69 61 6c | 20 5c 73 61 6d 70 7b 5c | initial| \samp{\|
|00000400| 7e 5c 76 61 72 7b 75 73 | 65 72 7d 7d 20 69 73 20 |~\var{us|er}} is |
|00000410| 6c 6f 6f 6b 65 64 20 75 | 70 20 69 6e 20 74 68 65 |looked u|p in the|
|00000420| 20 70 61 73 73 77 6f 72 | 64 20 64 69 72 65 63 74 | passwor|d direct|
|00000430| 6f 72 79 20 74 68 72 6f | 75 67 68 0d 74 68 65 20 |ory thro|ugh.the |
|00000440| 62 75 69 6c 74 2d 69 6e | 20 6d 6f 64 75 6c 65 20 |built-in| module |
|00000450| 5c 63 6f 64 65 7b 70 77 | 64 7d 2e 20 20 49 66 20 |\code{pw|d}.  If |
|00000460| 74 68 65 20 65 78 70 61 | 6e 73 69 6f 6e 20 66 61 |the expa|nsion fa|
|00000470| 69 6c 73 2c 20 6f 72 20 | 69 66 20 74 68 65 0d 70 |ils, or |if the.p|
|00000480| 61 74 68 20 64 6f 65 73 | 20 6e 6f 74 20 62 65 67 |ath does| not beg|
|00000490| 69 6e 20 77 69 74 68 20 | 61 20 74 69 6c 64 65 2c |in with |a tilde,|
|000004a0| 20 74 68 65 20 70 61 74 | 68 20 69 73 20 72 65 74 | the pat|h is ret|
|000004b0| 75 72 6e 65 64 20 75 6e | 63 68 61 6e 67 65 64 2e |urned un|changed.|
|000004c0| 0d 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0d |.\end{fu|ncdesc}.|
|000004d0| 0d 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|000004e0| 7d 7b 65 78 70 61 6e 64 | 76 61 72 73 7d 7b 70 7d |}{expand|vars}{p}|
|000004f0| 0d 52 65 74 75 72 6e 20 | 74 68 65 20 61 72 67 75 |.Return |the argu|
|00000500| 6d 65 6e 74 20 77 69 74 | 68 20 65 6e 76 69 72 6f |ment wit|h enviro|
|00000510| 6e 6d 65 6e 74 20 76 61 | 72 69 61 62 6c 65 73 20 |nment va|riables |
|00000520| 65 78 70 61 6e 64 65 64 | 2e 20 20 53 75 62 73 74 |expanded|.  Subst|
|00000530| 72 69 6e 67 73 0d 6f 66 | 20 74 68 65 20 66 6f 72 |rings.of| the for|
|00000540| 6d 20 5c 73 61 6d 70 7b | 5c 24 5c 76 61 72 7b 6e |m \samp{|\$\var{n|
|00000550| 61 6d 65 7d 7d 20 6f 72 | 20 5c 73 61 6d 70 7b 5c |ame}} or| \samp{\|
|00000560| 24 5c 7b 5c 76 61 72 7b | 6e 61 6d 65 7d 5c 7d 7d |$\{\var{|name}\}}|
|00000570| 20 61 72 65 0d 72 65 70 | 6c 61 63 65 64 20 62 79 | are.rep|laced by|
|00000580| 20 74 68 65 20 76 61 6c | 75 65 20 6f 66 20 65 6e | the val|ue of en|
|00000590| 76 69 72 6f 6e 6d 65 6e | 74 20 76 61 72 69 61 62 |vironmen|t variab|
|000005a0| 6c 65 20 5c 76 61 72 7b | 6e 61 6d 65 7d 2e 20 20 |le \var{|name}.  |
|000005b0| 4d 61 6c 66 6f 72 6d 65 | 64 0d 76 61 72 69 61 62 |Malforme|d.variab|
|000005c0| 6c 65 20 6e 61 6d 65 73 | 20 61 6e 64 20 72 65 66 |le names| and ref|
|000005d0| 65 72 65 6e 63 65 73 20 | 74 6f 20 6e 6f 6e 2d 65 |erences |to non-e|
|000005e0| 78 69 73 74 69 6e 67 20 | 76 61 72 69 61 62 6c 65 |xisting |variable|
|000005f0| 73 20 61 72 65 20 6c 65 | 66 74 0d 75 6e 63 68 61 |s are le|ft.uncha|
|00000600| 6e 67 65 64 2e 0d 5c 65 | 6e 64 7b 66 75 6e 63 64 |nged..\e|nd{funcd|
|00000610| 65 73 63 7d 0d 0d 5c 62 | 65 67 69 6e 7b 66 75 6e |esc}..\b|egin{fun|
|00000620| 63 64 65 73 63 7d 7b 69 | 73 61 62 73 7d 7b 70 7d |cdesc}{i|sabs}{p}|
|00000630| 0d 52 65 74 75 72 6e 20 | 74 72 75 65 20 69 66 20 |.Return |true if |
|00000640| 5c 76 61 72 7b 70 7d 20 | 69 73 20 61 6e 20 61 62 |\var{p} |is an ab|
|00000650| 73 6f 6c 75 74 65 20 70 | 61 74 68 6e 61 6d 65 20 |solute p|athname |
|00000660| 28 62 65 67 69 6e 73 20 | 77 69 74 68 20 61 20 73 |(begins |with a s|
|00000670| 6c 61 73 68 29 2e 0d 5c | 65 6e 64 7b 66 75 6e 63 |lash)..\|end{func|
|00000680| 64 65 73 63 7d 0d 0d 5c | 62 65 67 69 6e 7b 66 75 |desc}..\|begin{fu|
|00000690| 6e 63 64 65 73 63 7d 7b | 69 73 66 69 6c 65 7d 7b |ncdesc}{|isfile}{|
|000006a0| 70 7d 0d 52 65 74 75 72 | 6e 20 74 72 75 65 20 69 |p}.Retur|n true i|
|000006b0| 66 20 5c 76 61 72 7b 70 | 7d 20 69 73 20 61 6e 20 |f \var{p|} is an |
|000006c0| 65 78 69 73 74 69 6e 67 | 20 72 65 67 75 6c 61 72 |existing| regular|
|000006d0| 20 66 69 6c 65 2e 20 20 | 54 68 69 73 20 66 6f 6c | file.  |This fol|
|000006e0| 6c 6f 77 73 0d 73 79 6d | 62 6f 6c 69 63 20 6c 69 |lows.sym|bolic li|
|000006f0| 6e 6b 73 2c 20 73 6f 20 | 62 6f 74 68 20 5c 63 6f |nks, so |both \co|
|00000700| 64 65 7b 69 73 6c 69 6e | 6b 28 29 7d 20 61 6e 64 |de{islin|k()} and|
|00000710| 20 5c 63 6f 64 65 7b 69 | 73 66 69 6c 65 28 29 7d | \code{i|sfile()}|
|00000720| 20 63 61 6e 20 62 65 20 | 74 72 75 65 20 66 6f 72 | can be |true for|
|00000730| 20 74 68 65 20 73 61 6d | 65 0d 70 61 74 68 2e 0d | the sam|e.path..|
|00000740| 5c 65 6e 64 7b 66 75 6e | 63 64 65 73 63 7d 0d 0d |\end{fun|cdesc}..|
|00000750| 5c 62 65 67 69 6e 7b 66 | 75 6e 63 64 65 73 63 7d |\begin{f|uncdesc}|
|00000760| 7b 69 73 64 69 72 7d 7b | 70 7d 0d 52 65 74 75 72 |{isdir}{|p}.Retur|
|00000770| 6e 20 74 72 75 65 20 69 | 66 20 5c 76 61 72 7b 70 |n true i|f \var{p|
|00000780| 7d 20 69 73 20 61 6e 20 | 65 78 69 73 74 69 6e 67 |} is an |existing|
|00000790| 20 64 69 72 65 63 74 6f | 72 79 2e 20 20 54 68 69 | directo|ry.  Thi|
|000007a0| 73 20 66 6f 6c 6c 6f 77 | 73 0d 73 79 6d 62 6f 6c |s follow|s.symbol|
|000007b0| 69 63 20 6c 69 6e 6b 73 | 2c 20 73 6f 20 62 6f 74 |ic links|, so bot|
|000007c0| 68 20 5c 63 6f 64 65 7b | 69 73 6c 69 6e 6b 28 29 |h \code{|islink()|
|000007d0| 7d 20 61 6e 64 20 5c 63 | 6f 64 65 7b 69 73 64 69 |} and \c|ode{isdi|
|000007e0| 72 28 29 7d 20 63 61 6e | 20 62 65 20 74 72 75 65 |r()} can| be true|
|000007f0| 20 66 6f 72 20 74 68 65 | 20 73 61 6d 65 0d 70 61 | for the| same.pa|
|00000800| 74 68 2e 0d 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |th..\end|{funcdes|
|00000810| 63 7d 0d 0d 5c 62 65 67 | 69 6e 7b 66 75 6e 63 64 |c}..\beg|in{funcd|
|00000820| 65 73 63 7d 7b 69 73 6c | 69 6e 6b 7d 7b 70 7d 0d |esc}{isl|ink}{p}.|
|00000830| 52 65 74 75 72 6e 20 74 | 72 75 65 20 69 66 0d 5c |Return t|rue if.\|
|00000840| 76 61 72 7b 70 7d 0d 72 | 65 66 65 72 73 20 74 6f |var{p}.r|efers to|
|00000850| 20 61 20 64 69 72 65 63 | 74 6f 72 79 20 65 6e 74 | a direc|tory ent|
|00000860| 72 79 20 74 68 61 74 20 | 69 73 20 61 20 73 79 6d |ry that |is a sym|
|00000870| 62 6f 6c 69 63 20 6c 69 | 6e 6b 2e 0d 41 6c 77 61 |bolic li|nk..Alwa|
|00000880| 79 73 20 66 61 6c 73 65 | 20 69 66 20 73 79 6d 62 |ys false| if symb|
|00000890| 6f 6c 69 63 20 6c 69 6e | 6b 73 20 61 72 65 20 6e |olic lin|ks are n|
|000008a0| 6f 74 20 73 75 70 70 6f | 72 74 65 64 2e 0d 5c 65 |ot suppo|rted..\e|
|000008b0| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0d 0d 5c 62 |nd{funcd|esc}..\b|
|000008c0| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 69 |egin{fun|cdesc}{i|
|000008d0| 73 6d 6f 75 6e 74 7d 7b | 70 7d 0d 52 65 74 75 72 |smount}{|p}.Retur|
|000008e0| 6e 20 74 72 75 65 20 69 | 66 20 70 61 74 68 6e 61 |n true i|f pathna|
|000008f0| 6d 65 20 5c 76 61 72 7b | 70 7d 20 69 73 20 61 20 |me \var{|p} is a |
|00000900| 5c 64 66 6e 7b 6d 6f 75 | 6e 74 20 70 6f 69 6e 74 |\dfn{mou|nt point|
|00000910| 7d 3a 20 61 20 70 6f 69 | 6e 74 20 69 6e 20 61 0d |}: a poi|nt in a.|
|00000920| 66 69 6c 65 20 73 79 73 | 74 65 6d 20 77 68 65 72 |file sys|tem wher|
|00000930| 65 20 61 20 64 69 66 66 | 65 72 65 6e 74 20 66 69 |e a diff|erent fi|
|00000940| 6c 65 20 73 79 73 74 65 | 6d 20 68 61 73 20 62 65 |le syste|m has be|
|00000950| 65 6e 20 6d 6f 75 6e 74 | 65 64 2e 20 20 54 68 65 |en mount|ed.  The|
|00000960| 0d 66 75 6e 63 74 69 6f | 6e 20 63 68 65 63 6b 73 |.functio|n checks|
|00000970| 20 77 68 65 74 68 65 72 | 20 5c 76 61 72 7b 70 7d | whether| \var{p}|
|00000980| 27 73 20 70 61 72 65 6e | 74 2c 20 5c 66 69 6c 65 |'s paren|t, \file|
|00000990| 7b 5c 76 61 72 7b 70 7d | 2f 2e 2e 7d 2c 20 69 73 |{\var{p}|/..}, is|
|000009a0| 20 6f 6e 20 61 0d 64 69 | 66 66 65 72 65 6e 74 20 | on a.di|fferent |
|000009b0| 64 65 76 69 63 65 20 74 | 68 61 6e 20 5c 76 61 72 |device t|han \var|
|000009c0| 7b 70 7d 2c 20 6f 72 20 | 77 68 65 74 68 65 72 20 |{p}, or |whether |
|000009d0| 5c 66 69 6c 65 7b 5c 76 | 61 72 7b 70 7d 2f 2e 2e |\file{\v|ar{p}/..|
|000009e0| 7d 20 61 6e 64 0d 5c 76 | 61 72 7b 70 7d 20 70 6f |} and.\v|ar{p} po|
|000009f0| 69 6e 74 20 74 6f 20 74 | 68 65 20 73 61 6d 65 20 |int to t|he same |
|00000a00| 69 2d 6e 6f 64 65 20 6f | 6e 20 74 68 65 20 73 61 |i-node o|n the sa|
|00000a10| 6d 65 20 64 65 76 69 63 | 65 20 2d 2d 2d 20 74 68 |me devic|e --- th|
|00000a20| 69 73 20 73 68 6f 75 6c | 64 0d 64 65 74 65 63 74 |is shoul|d.detect|
|00000a30| 20 6d 6f 75 6e 74 20 70 | 6f 69 6e 74 73 20 66 6f | mount p|oints fo|
|00000a40| 72 20 61 6c 6c 20 5c 55 | 4e 49 58 7b 7d 20 61 6e |r all \U|NIX{} an|
|00000a50| 64 20 50 4f 53 49 58 20 | 76 61 72 69 61 6e 74 73 |d POSIX |variants|
|00000a60| 2e 0d 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |..\end{f|uncdesc}|
|00000a70| 0d 0d 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00000a80| 63 7d 7b 6a 6f 69 6e 7d | 7b 70 5c 2c 20 71 7d 0d |c}{join}|{p\, q}.|
|00000a90| 4a 6f 69 6e 20 74 68 65 | 20 70 61 74 68 73 0d 5c |Join the| paths.\|
|00000aa0| 76 61 72 7b 70 7d 0d 61 | 6e 64 0d 5c 76 61 72 7b |var{p}.a|nd.\var{|
|00000ab0| 71 7d 20 69 6e 74 65 6c | 6c 69 67 65 6e 74 6c 79 |q} intel|ligently|
|00000ac0| 3a 0d 49 66 0d 5c 76 61 | 72 7b 71 7d 0d 69 73 20 |:.If.\va|r{q}.is |
|00000ad0| 61 6e 20 61 62 73 6f 6c | 75 74 65 20 70 61 74 68 |an absol|ute path|
|00000ae0| 2c 20 74 68 65 20 72 65 | 74 75 72 6e 20 76 61 6c |, the re|turn val|
|00000af0| 75 65 20 69 73 0d 5c 76 | 61 72 7b 71 7d 2e 0d 4f |ue is.\v|ar{q}..O|
|00000b00| 74 68 65 72 77 69 73 65 | 2c 20 74 68 65 20 63 6f |therwise|, the co|
|00000b10| 6e 63 61 74 65 6e 61 74 | 69 6f 6e 20 6f 66 0d 5c |ncatenat|ion of.\|
|00000b20| 76 61 72 7b 70 7d 0d 61 | 6e 64 0d 5c 76 61 72 7b |var{p}.a|nd.\var{|
|00000b30| 71 7d 0d 69 73 20 72 65 | 74 75 72 6e 65 64 2c 20 |q}.is re|turned, |
|00000b40| 77 69 74 68 20 61 20 73 | 6c 61 73 68 20 28 5c 63 |with a s|lash (\c|
|00000b50| 6f 64 65 7b 27 2f 27 7d | 29 20 69 6e 73 65 72 74 |ode{'/'}|) insert|
|00000b60| 65 64 20 75 6e 6c 65 73 | 73 0d 5c 76 61 72 7b 70 |ed unles|s.\var{p|
|00000b70| 7d 0d 69 73 20 65 6d 70 | 74 79 20 6f 72 20 65 6e |}.is emp|ty or en|
|00000b80| 64 73 20 69 6e 20 61 20 | 73 6c 61 73 68 2e 0d 5c |ds in a |slash..\|
|00000b90| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0d 0d 5c |end{func|desc}..\|
|00000ba0| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|00000bb0| 6e 6f 72 6d 63 61 73 65 | 7d 7b 70 7d 0d 4e 6f 72 |normcase|}{p}.Nor|
|00000bc0| 6d 61 6c 69 7a 65 20 74 | 68 65 20 63 61 73 65 20 |malize t|he case |
|00000bd0| 6f 66 20 61 20 70 61 74 | 68 6e 61 6d 65 2e 20 20 |of a pat|hname.  |
|00000be0| 54 68 69 73 20 72 65 74 | 75 72 6e 73 20 74 68 65 |This ret|urns the|
|00000bf0| 20 70 61 74 68 20 75 6e | 63 68 61 6e 67 65 64 3b | path un|changed;|
|00000c00| 0d 68 6f 77 65 76 65 72 | 2c 20 61 20 73 69 6d 69 |.however|, a simi|
|00000c10| 6c 61 72 20 66 75 6e 63 | 74 69 6f 6e 20 69 6e 20 |lar func|tion in |
|00000c20| 5c 63 6f 64 65 7b 6d 61 | 63 70 61 74 68 7d 20 63 |\code{ma|cpath} c|
|00000c30| 6f 6e 76 65 72 74 73 20 | 75 70 70 65 72 20 63 61 |onverts |upper ca|
|00000c40| 73 65 20 74 6f 0d 6c 6f | 77 65 72 20 63 61 73 65 |se to.lo|wer case|
|00000c50| 2e 0d 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |..\end{f|uncdesc}|
|00000c60| 0d 0d 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00000c70| 63 7d 7b 73 61 6d 65 66 | 69 6c 65 7d 7b 70 5c 2c |c}{samef|ile}{p\,|
|00000c80| 20 71 7d 0d 52 65 74 75 | 72 6e 20 74 72 75 65 20 | q}.Retu|rn true |
|00000c90| 69 66 20 62 6f 74 68 20 | 70 61 74 68 6e 61 6d 65 |if both |pathname|
|00000ca0| 20 61 72 67 75 6d 65 6e | 74 73 20 72 65 66 65 72 | argumen|ts refer|
|00000cb0| 20 74 6f 20 74 68 65 20 | 73 61 6d 65 20 66 69 6c | to the |same fil|
|00000cc0| 65 20 6f 72 20 64 69 72 | 65 63 74 6f 72 79 0d 28 |e or dir|ectory.(|
|00000cd0| 61 73 20 69 6e 64 69 63 | 61 74 65 64 20 62 79 20 |as indic|ated by |
|00000ce0| 64 65 76 69 63 65 20 6e | 75 6d 62 65 72 20 61 6e |device n|umber an|
|00000cf0| 64 20 69 2d 6e 6f 64 65 | 20 6e 75 6d 62 65 72 29 |d i-node| number)|
|00000d00| 2e 0d 52 61 69 73 65 20 | 61 6e 20 65 78 63 65 70 |..Raise |an excep|
|00000d10| 74 69 6f 6e 20 69 66 20 | 61 20 73 74 61 74 20 63 |tion if |a stat c|
|00000d20| 61 6c 6c 20 6f 6e 20 65 | 69 74 68 65 72 20 70 61 |all on e|ither pa|
|00000d30| 74 68 6e 61 6d 65 20 66 | 61 69 6c 73 2e 0d 5c 65 |thname f|ails..\e|
|00000d40| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0d 0d 5c 62 |nd{funcd|esc}..\b|
|00000d50| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 73 |egin{fun|cdesc}{s|
|00000d60| 70 6c 69 74 7d 7b 70 7d | 0d 53 70 6c 69 74 20 74 |plit}{p}|.Split t|
|00000d70| 68 65 20 70 61 74 68 6e | 61 6d 65 20 5c 76 61 72 |he pathn|ame \var|
|00000d80| 7b 70 7d 20 69 6e 20 61 | 20 70 61 69 72 20 5c 63 |{p} in a| pair \c|
|00000d90| 6f 64 65 7b 28 5c 76 61 | 72 7b 68 65 61 64 7d 2c |ode{(\va|r{head},|
|00000da0| 20 5c 76 61 72 7b 74 61 | 69 6c 7d 29 7d 2c 20 77 | \var{ta|il})}, w|
|00000db0| 68 65 72 65 0d 5c 76 61 | 72 7b 74 61 69 6c 7d 20 |here.\va|r{tail} |
|00000dc0| 69 73 20 74 68 65 20 6c | 61 73 74 20 70 61 74 68 |is the l|ast path|
|00000dd0| 6e 61 6d 65 20 63 6f 6d | 70 6f 6e 65 6e 74 20 61 |name com|ponent a|
|00000de0| 6e 64 20 5c 76 61 72 7b | 68 65 61 64 7d 20 69 73 |nd \var{|head} is|
|00000df0| 0d 65 76 65 72 79 74 68 | 69 6e 67 20 6c 65 61 64 |.everyth|ing lead|
|00000e00| 69 6e 67 20 75 70 20 74 | 6f 20 74 68 61 74 2e 20 |ing up t|o that. |
|00000e10| 20 49 66 20 5c 76 61 72 | 7b 70 7d 20 65 6e 64 73 | If \var|{p} ends|
|00000e20| 20 69 6e 20 61 20 73 6c | 61 73 68 20 28 65 78 63 | in a sl|ash (exc|
|00000e30| 65 70 74 20 69 66 0d 69 | 74 20 69 73 20 74 68 65 |ept if.i|t is the|
|00000e40| 20 72 6f 6f 74 29 2c 20 | 74 68 65 20 74 72 61 69 | root), |the trai|
|00000e50| 6c 69 6e 67 20 73 6c 61 | 73 68 20 69 73 20 72 65 |ling sla|sh is re|
|00000e60| 6d 6f 76 65 64 20 61 6e | 64 20 74 68 65 20 6f 70 |moved an|d the op|
|00000e70| 65 72 61 74 69 6f 6e 0d | 61 70 70 6c 69 65 64 20 |eration.|applied |
|00000e80| 74 6f 20 74 68 65 20 72 | 65 73 75 6c 74 3b 20 6f |to the r|esult; o|
|00000e90| 74 68 65 72 77 69 73 65 | 2c 20 5c 63 6f 64 65 7b |therwise|, \code{|
|00000ea0| 6a 6f 69 6e 28 5c 76 61 | 72 7b 68 65 61 64 7d 2c |join(\va|r{head},|
|00000eb0| 20 5c 76 61 72 7b 74 61 | 69 6c 7d 29 7d 20 65 71 | \var{ta|il})} eq|
|00000ec0| 75 61 6c 73 0d 5c 76 61 | 72 7b 70 7d 2e 20 20 54 |uals.\va|r{p}.  T|
|00000ed0| 68 65 20 5c 76 61 72 7b | 74 61 69 6c 7d 20 70 61 |he \var{|tail} pa|
|00000ee0| 72 74 20 6e 65 76 65 72 | 20 63 6f 6e 74 61 69 6e |rt never| contain|
|00000ef0| 73 20 61 20 73 6c 61 73 | 68 2e 20 20 53 6f 6d 65 |s a slas|h.  Some|
|00000f00| 20 62 6f 75 6e 64 61 72 | 79 0d 63 61 73 65 73 3a | boundar|y.cases:|
|00000f10| 5c 20 69 66 20 5c 76 61 | 72 7b 70 7d 20 69 73 20 |\ if \va|r{p} is |
|00000f20| 74 68 65 20 72 6f 6f 74 | 2c 20 5c 76 61 72 7b 68 |the root|, \var{h|
|00000f30| 65 61 64 7d 20 65 71 75 | 61 6c 73 20 5c 76 61 72 |ead} equ|als \var|
|00000f40| 7b 70 7d 20 61 6e 64 0d | 5c 76 61 72 7b 74 61 69 |{p} and.|\var{tai|
|00000f50| 6c 7d 20 69 73 20 65 6d | 70 74 79 3b 20 69 66 20 |l} is em|pty; if |
|00000f60| 5c 76 61 72 7b 70 7d 20 | 69 73 20 65 6d 70 74 79 |\var{p} |is empty|
|00000f70| 2c 20 62 6f 74 68 20 5c | 76 61 72 7b 68 65 61 64 |, both \|var{head|
|00000f80| 7d 20 61 6e 64 0d 5c 76 | 61 72 7b 74 61 69 6c 7d |} and.\v|ar{tail}|
|00000f90| 20 61 72 65 20 65 6d 70 | 74 79 3b 20 69 66 20 5c | are emp|ty; if \|
|00000fa0| 76 61 72 7b 70 7d 20 63 | 6f 6e 74 61 69 6e 73 20 |var{p} c|ontains |
|00000fb0| 6e 6f 20 73 6c 61 73 68 | 2c 20 5c 76 61 72 7b 68 |no slash|, \var{h|
|00000fc0| 65 61 64 7d 20 69 73 0d | 65 6d 70 74 79 20 61 6e |ead} is.|empty an|
|00000fd0| 64 20 5c 76 61 72 7b 74 | 61 69 6c 7d 20 65 71 75 |d \var{t|ail} equ|
|00000fe0| 61 6c 73 20 5c 76 61 72 | 7b 70 7d 2e 0d 5c 65 6e |als \var|{p}..\en|
|00000ff0| 64 7b 66 75 6e 63 64 65 | 73 63 7d 0d 0d 5c 62 65 |d{funcde|sc}..\be|
|00001000| 67 69 6e 7b 66 75 6e 63 | 64 65 73 63 7d 7b 73 70 |gin{func|desc}{sp|
|00001010| 6c 69 74 65 78 74 7d 7b | 70 7d 0d 53 70 6c 69 74 |litext}{|p}.Split|
|00001020| 20 74 68 65 20 70 61 74 | 68 6e 61 6d 65 20 5c 76 | the pat|hname \v|
|00001030| 61 72 7b 70 7d 20 69 6e | 20 61 20 70 61 69 72 20 |ar{p} in| a pair |
|00001040| 5c 63 6f 64 65 7b 28 5c | 76 61 72 7b 72 6f 6f 74 |\code{(\|var{root|
|00001050| 7d 2c 20 5c 76 61 72 7b | 65 78 74 7d 29 7d 0d 73 |}, \var{|ext})}.s|
|00001060| 75 63 68 20 74 68 61 74 | 20 5c 63 6f 64 65 7b 5c |uch that| \code{\|
|00001070| 76 61 72 7b 72 6f 6f 74 | 7d 20 2b 20 5c 76 61 72 |var{root|} + \var|
|00001080| 7b 65 78 74 7d 20 3d 3d | 20 5c 76 61 72 7b 70 7d |{ext} ==| \var{p}|
|00001090| 7d 2c 0d 74 68 65 20 6c | 61 73 74 20 63 6f 6d 70 |},.the l|ast comp|
|000010a0| 6f 6e 65 6e 74 20 6f 66 | 20 5c 76 61 72 7b 72 6f |onent of| \var{ro|
|000010b0| 6f 74 7d 20 63 6f 6e 74 | 61 69 6e 73 20 6e 6f 20 |ot} cont|ains no |
|000010c0| 70 65 72 69 6f 64 73 2c | 0d 61 6e 64 20 5c 76 61 |periods,|.and \va|
|000010d0| 72 7b 65 78 74 7d 20 69 | 73 20 65 6d 70 74 79 20 |r{ext} i|s empty |
|000010e0| 6f 72 20 62 65 67 69 6e | 73 20 77 69 74 68 20 61 |or begin|s with a|
|000010f0| 20 70 65 72 69 6f 64 2e | 0d 5c 65 6e 64 7b 66 75 | period.|.\end{fu|
|00001100| 6e 63 64 65 73 63 7d 0d | 0d 5c 62 65 67 69 6e 7b |ncdesc}.|.\begin{|
|00001110| 66 75 6e 63 64 65 73 63 | 7d 7b 77 61 6c 6b 7d 7b |funcdesc|}{walk}{|
|00001120| 70 5c 2c 20 76 69 73 69 | 74 5c 2c 20 61 72 67 7d |p\, visi|t\, arg}|
|00001130| 0d 43 61 6c 6c 73 20 74 | 68 65 20 66 75 6e 63 74 |.Calls t|he funct|
|00001140| 69 6f 6e 20 5c 76 61 72 | 7b 76 69 73 69 74 7d 20 |ion \var|{visit} |
|00001150| 77 69 74 68 20 61 72 67 | 75 6d 65 6e 74 73 0d 5c |with arg|uments.\|
|00001160| 63 6f 64 65 7b 28 5c 76 | 61 72 7b 61 72 67 7d 2c |code{(\v|ar{arg},|
|00001170| 20 5c 76 61 72 7b 64 69 | 72 6e 61 6d 65 7d 2c 20 | \var{di|rname}, |
|00001180| 5c 76 61 72 7b 6e 61 6d | 65 73 7d 29 7d 20 66 6f |\var{nam|es})} fo|
|00001190| 72 20 65 61 63 68 20 64 | 69 72 65 63 74 6f 72 79 |r each d|irectory|
|000011a0| 20 69 6e 20 74 68 65 0d | 64 69 72 65 63 74 6f 72 | in the.|director|
|000011b0| 79 20 74 72 65 65 20 72 | 6f 6f 74 65 64 20 61 74 |y tree r|ooted at|
|000011c0| 20 5c 76 61 72 7b 70 7d | 20 28 69 6e 63 6c 75 64 | \var{p}| (includ|
|000011d0| 69 6e 67 20 5c 76 61 72 | 7b 70 7d 20 69 74 73 65 |ing \var|{p} itse|
|000011e0| 6c 66 2c 20 69 66 20 69 | 74 20 69 73 20 61 0d 64 |lf, if i|t is a.d|
|000011f0| 69 72 65 63 74 6f 72 79 | 29 2e 20 20 54 68 65 20 |irectory|).  The |
|00001200| 61 72 67 75 6d 65 6e 74 | 20 5c 76 61 72 7b 64 69 |argument| \var{di|
|00001210| 72 6e 61 6d 65 7d 20 73 | 70 65 63 69 66 69 65 73 |rname} s|pecifies|
|00001220| 20 74 68 65 20 76 69 73 | 69 74 65 64 20 64 69 72 | the vis|ited dir|
|00001230| 65 63 74 6f 72 79 2c 0d | 74 68 65 20 61 72 67 75 |ectory,.|the argu|
|00001240| 6d 65 6e 74 20 5c 76 61 | 72 7b 6e 61 6d 65 73 7d |ment \va|r{names}|
|00001250| 20 6c 69 73 74 73 20 74 | 68 65 20 66 69 6c 65 73 | lists t|he files|
|00001260| 20 69 6e 20 74 68 65 20 | 64 69 72 65 63 74 6f 72 | in the |director|
|00001270| 79 20 28 67 6f 74 74 65 | 6e 20 66 72 6f 6d 0d 5c |y (gotte|n from.\|
|00001280| 63 6f 64 65 7b 70 6f 73 | 69 78 2e 6c 69 73 74 64 |code{pos|ix.listd|
|00001290| 69 72 28 5c 76 61 72 7b | 64 69 72 6e 61 6d 65 7d |ir(\var{|dirname}|
|000012a0| 29 7d 2c 20 73 6f 20 69 | 6e 63 6c 75 64 69 6e 67 |)}, so i|ncluding|
|000012b0| 20 5c 73 61 6d 70 7b 2e | 7d 20 61 6e 64 0d 5c 73 | \samp{.|} and.\s|
|000012c0| 61 6d 70 7b 2e 2e 7d 29 | 2e 20 20 54 68 65 20 5c |amp{..})|.  The \|
|000012d0| 76 61 72 7b 76 69 73 69 | 74 7d 20 66 75 6e 63 74 |var{visi|t} funct|
|000012e0| 69 6f 6e 20 6d 61 79 20 | 6d 6f 64 69 66 79 20 5c |ion may |modify \|
|000012f0| 76 61 72 7b 6e 61 6d 65 | 73 7d 20 74 6f 0d 69 6e |var{name|s} to.in|
|00001300| 66 6c 75 65 6e 63 65 20 | 74 68 65 20 73 65 74 20 |fluence |the set |
|00001310| 6f 66 20 64 69 72 65 63 | 74 6f 72 69 65 73 20 76 |of direc|tories v|
|00001320| 69 73 69 74 65 64 20 62 | 65 6c 6f 77 20 5c 76 61 |isited b|elow \va|
|00001330| 72 7b 64 69 72 6e 61 6d | 65 7d 2c 20 65 2e 67 2e |r{dirnam|e}, e.g.|
|00001340| 2c 20 74 6f 0d 61 76 6f | 69 64 20 76 69 73 69 74 |, to.avo|id visit|
|00001350| 69 6e 67 20 63 65 72 74 | 61 69 6e 20 70 61 72 74 |ing cert|ain part|
|00001360| 73 20 6f 66 20 74 68 65 | 20 74 72 65 65 2e 20 20 |s of the| tree.  |
|00001370| 28 54 68 65 20 6f 62 6a | 65 63 74 20 72 65 66 65 |(The obj|ect refe|
|00001380| 72 72 65 64 20 74 6f 20 | 62 79 0d 5c 76 61 72 7b |rred to |by.\var{|
|00001390| 6e 61 6d 65 73 7d 20 6d | 75 73 74 20 62 65 20 6d |names} m|ust be m|
|000013a0| 6f 64 69 66 69 65 64 20 | 69 6e 20 70 6c 61 63 65 |odified |in place|
|000013b0| 2c 20 75 73 69 6e 67 20 | 5c 63 6f 64 65 7b 64 65 |, using |\code{de|
|000013c0| 6c 7d 20 6f 72 20 73 6c | 69 63 65 0d 61 73 73 69 |l} or sl|ice.assi|
|000013d0| 67 6e 6d 65 6e 74 2e 29 | 0d 5c 65 6e 64 7b 66 75 |gnment.)|.\end{fu|
|000013e0| 6e 63 64 65 73 63 7d 0d |                         |ncdesc}.|        |
+--------+-------------------------+-------------------------+--------+--------+